home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 November / macformat-018.iso / Comms Spectacular / Archie / Archie Doc next >
Encoding:
Text File  |  1992-12-10  |  4.8 KB  |  135 lines  |  [ttro/ttxt]

  1.                                 ARCHIE Version 0.9 manual
  2.  
  3. This is my first cut at an Archie client for the mac. It is still beta but I decided to release it as I've had many requests for it.
  4.  
  5.  
  6. What is Archie ? 
  7. Archie is client-server system that allows you to query a database containing entries for files available via anonymous FTP.
  8. Archie was concieved and created at McGill University.
  9.  
  10. Who runs servers ?
  11. Currently servers are available at the following locations:
  12.  
  13.  archie.rutgers.edu   128.6.18.15     (Rutgers University)
  14.  archie.unl.edu          129.93.1.14     (U of Nebraska in Lincoln)
  15.  archie.sura.net         128.167.254.179 (SURAnet archie server)
  16.  archie.ans.net          147.225.1.2     (ANS archie server)
  17.  archie.au                 139.130.4.6     (Australian server)
  18.  archie.funet.fi         128.214.6.100   (European server in Finland)
  19.  archie..mcgill.ca      (Unavailable at this time)
  20.  
  21.  
  22. What protocol does Archie use ?
  23. Archie queries a database using  Clifford Neuman's Prospero protocol. Requests are handled by a server in a queued fashion. Be prepared to wait from minutes to hours for a response.
  24.  
  25. Using Archie:
  26.  
  27. Archie requires MacTCP to be installed on your machine. It has been tested only on machines running system 7.
  28.  
  29. This client has be in use for a couple of months and seems to be stable but as it is still beta there are no guarantees.
  30.  
  31. The File and Edit menus are fairly standard so I am not going to discuss them.
  32.  
  33. The Prefs Menu:
  34.  
  35. Archie Server:
  36. The first time you run Archie you should set the server to query.
  37. This is set by selecting Archie Server menu item under the Prefs menu. Set the Archie server to one of the previously mentioned Archie server sites (Select the one closest to your site)
  38.  
  39. Save Docs As:
  40. Allows you to select the format to save the results of an Archie Query. Currently only TeachText, MacWrite and MS Word are available. Future versions of Archie will allow you to select a format of your choice.
  41.  
  42. Sound Notification:
  43. If this Option is selected Archie will notify you when a query is complete by playing a sound. If not selected notification is by flashing icon only. ( Note: Notification only occurres when Archie is in the background) 
  44.  
  45.  
  46. The Archie Query Window
  47.  
  48. Selecting New from the file menu will open a new Archie query window.
  49.  
  50.  To send a query:
  51.          -first set the Search Type  by selecting one of the avaliable     
  52.           options. Use balloon help to find out more about these options.
  53.  
  54.         - Type in a search string and press the Search button ( or the 
  55.              return key)
  56.  
  57.         - Wait ( sometimes minutes sometimes hours). It is a good idea
  58.              to put Archie in the background and continue one with other 
  59.              things.
  60.  
  61. Note: You can send multiple Archie Queries. You don't have to wait for a query to finish before sending a new one.
  62.  
  63. Questions:
  64.  
  65. How to I know if the server got my query ?
  66.  
  67. Archie uses UDP therefore there is never a connection between the
  68. client and server but soon after a query is sent you sould receive 
  69. 11 bytes back from the server. This tells you that the server has queued your request.
  70.  
  71. How come my requests take so long ?
  72.  
  73. Archie servers queue up requests and answer them in the order received ( also based on niceness level). If it is slow that just means there are many requests ahead of yours.
  74.  
  75. What is niceness ?
  76.  
  77. The niceness level is the priority of your request. If you are searching for trivial information such as Games and other unmentionables you should set your queries to a nicer value.
  78.  
  79. Note: Niceness does not work in this Beta version. All requests are sent as normal priority. ( If any Archie gurus are out there please tell me how to make this work )
  80.  
  81. Wish list:
  82.  
  83. Here is my wish list for version 1. ( Suggested by my beta testers)
  84.  
  85. - Have a pop up list of Archie Servers to select from when setting your Archie Server
  86.  
  87. - Allow the user to select there own format to save result files as
  88.  
  89. - Automatically launch fetch to fetch a selected file when user  
  90.   selects a ftp server and file name from an Archie Result window.
  91.  
  92. - Allow user to print selected text instead of at least one page as 
  93.    is the case now.
  94.  
  95. - Other user suggestions please EMail me.
  96.  
  97. When will version 1 be released ?
  98.  
  99. I am doing this in my spare time so it may be awhile. It also depends on the interest shown by users. If users support this program by paying their shareware fees and making suggestions I will support the program.
  100.  
  101. How much does it cost ?
  102.  
  103. Archie is Shareware $6.00 US funds. Send to :
  104.  
  105. Chris McNeil
  106. Box 153
  107. Middle Sackville NB Canada
  108. EOA 2E0
  109.  
  110. If you want multiple copies, site licences, etc send me email and we will work something out.
  111.  
  112. I can be reached via email at:
  113.  
  114. cmcneil@mta.ca
  115.  
  116. Enjoy !
  117.  
  118.  
  119.  
  120. Warranty
  121.  
  122. This program is supplied as is , without any warrenty whether expressed or implied.
  123. The person using the software bears all risk incurred by its use.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.